;------------------ I N T R O D U T I O N ------------------;

- This is a brief page describing a few examples of skinbox uses.

- These examples are used with skinbox-1.0-beta_4.1.

- These are very basic examples. Read the readme that comes with 
  skinbox for a lot more possibilities of configuration, scripting
  and actions.

- Note: As this is a beta version of skinbox, there are a few things
  that will require tweaking (by the themer and\or by Rabidcow if he
  releases future versions).

  What I've noticed (and Rabidcow mentions in his readme) is that some
  of the settings are reversed. So instead of putting true, you would 
  put false.

  This applies to "TrueAlpha", "OnTop", and "Hidden". It may apply to
  others but these are the ones I've come across.


;------------------- E X A M P L E S -------------------;


- Each skinbox will need its own group of .rc entries.
  They are similiar in some ways to Label definitions.


- The first line needs to look something like this:

  *SkinBox AudioPrevious 345 2 15 25 #1

  That line defines the name of the skinbox, the x and
  y coordinates, the lenght and width of the skinbox, and
  the group number and flags. 

- After this, if you require more detail for your box you 
  will continue with the definitions by proceeding each
  line with the name of your skinbox, much like label works.
  For example:

  *SkinBox                            AudioPrevious 345 2 15 25 #1
  AudioPreviousTrueAlpha              true
  AudioPreviousOnTop                  false 
  AudioPreviousHidden                 false 
  AudioPreviousBitmap                 button1.png
  AudioPreviousEdgeLeft               0 
  AudioPreviousEdgeTop                0 
  AudioPreviousEdgeRight              0 
  AudioPreviousEdgeBottom             0
  AudioPreviousTile                   tile 
  AudioPreviousOnMouseOver            !SkinBoxBitmap AudioPrevious previous.png
  AudioPreviousOnMouseOut             !SkinBoxBitmap AudioPrevious button1.png
  AudioPreviousOnLButtonClick         !AMP_PREV


- As mentioned in my theme readme, the images in skinbox
  can be stretched. You can define the image itself, the
  areas of the image you don't want stretched (or tiled)
  and whether you want the image stretched or tiled. The
  following lines are an example of that. Keep in mind 
  you have defined the final size you want your skinbox
  to be, in the first line of the skinbox definition:
 
  AudioPreviousBitmap                 button1.png
  AudioPreviousEdgeLeft               0 
  AudioPreviousEdgeTop                0 
  AudioPreviousEdgeRight              0 
  AudioPreviousEdgeBottom             0
  AudioPreviousTile                   tile 


- As far as I can tell skinbox doesn't have a specific command
  for mouseover or mouseclick images, so I used the OnMouseOver
  command feature to replace the static image with a mouseover
  image and back again. The lines for that are:

  AudioPreviousOnMouseOver            !SkinBoxBitmap AudioPrevious previous.png
  AudioPreviousOnMouseOut             !SkinBoxBitmap AudioPrevious button1.png


- Lastly, you can define actions that the skinbox will execute
  for mouse-overs and button-clicks. All sorts of parameters
  are possible to ckeck the module readme for option. In my
  example, this line activiates a bang command for dynamp:

  AudioPreviousOnLButtonClick         !AMP_PREV

;------------------ C O N C L U S I O N ------------------;


- Hopefully my examples are helful to you as you
  play with this neat module. If there are mistakes
  in my examples, let me know so I can correct them.

- Big thanks go to Rabidcow, for this new module to play with.

- Phil Varcoe (Phar0e) December 03






